home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / kill.man < prev    next >
Encoding:
Text File  |  1988-12-30  |  1.8 KB  |  49 lines
  1. ' $Header: /a/newcmds/kill/RCS/kill.man,v 1.2 88/12/30 09:33:58 ouster Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS KILL cmds
  4. .BS
  5. .SH NAME
  6. kill \- Send a signal to a process or group
  7. .SH SYNOPSIS
  8. \fBkill\fR [\fIoptions\fR] \fIpid pid ...\fR
  9. .SH OPTIONS
  10. .IP "\fB\-g\fR" 15
  11. Treat each \fIpid\fR as the name of a process group rather than a process,
  12. and send the given signal to the entire group.
  13. .IP "\fB\-help\fR" 15
  14. Print a summary of the command-line options and exit without sending
  15. any signals.
  16. .IP "\fB\-l\fR" 15
  17. Print out a list of valid signal names and
  18. exit without sending any signals.
  19. .IP "\fB\-\fIsignal\fR" 15
  20. Send \fIsignal\fR to the given processes.  \fISignal\fR may be either
  21. a number or a symbolic name.  The legal names are the same as the
  22. names from the <signal.h> include file, except without the ``SIG''
  23. prefix.  \fISignal\fR defaults to \fBTERM\fR.
  24. .BE
  25.  
  26. .SH DESCRIPTION
  27. .LP
  28. This command sends a signal (usually a SIGTERM kill signal) to
  29. one or more processes.  Depending on how the processes have
  30. arranged for the signal to be handled, the processes may exit,
  31. enter the debugger, ignore the signal altogether, or execute a
  32. handler procedure within the process.  In the default case where
  33. the SIGTERM signal is used, the normal result is for the process
  34. to exit.
  35. See the \fBsigvec\fR manual page for more details on signal handling.
  36. .LP
  37. Note:  The C-shell (csh) contains a built-in command \fBkill\fR that
  38. behaves almost identically to this command (it doesn't support the
  39. \fB\-g\fR or \fB\-help\fR options, but is otherwise the same).  If you
  40. are running the C-shell and type \fBkill\fR, you will get the built-in
  41. command:  to get the program version, invoke \fBkill\fR by typing its
  42. absolute path name.
  43.  
  44. .SH "SEE ALSO"
  45. sigvec
  46.  
  47. .SH KEYWORDS
  48. group, kill, process, signal
  49.